home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / a_utils / _archvrs / amiga / dms_1_02.lzh / DMS.doc < prev    next >
Text File  |  1990-12-02  |  17KB  |  487 lines
  1. FILE: DMS.doc - AmigaDOS version 1.02 partial documentation  - 11/20/90
  2.  
  3. *****************************************************************************
  4.  
  5.                           The DISK-Masher
  6.                    Copyright (c) 1990 SDS Software
  7.  
  8.  
  9. *****************************************************************************
  10.  
  11.  
  12. What is it?
  13.  
  14.     The DISK-Masher (DMS) is a utility that allows users to compress and
  15. archive floppy disks.  Version 1.02 requires at least 512k of memory, and
  16. AmigaDOS version 1.2 or later.
  17.  
  18. Why a disk archiver?
  19.  
  20.     Many programs are available for archiving individual files and do a
  21. relatively good job.  However DMS was created for the purpose of archiving
  22. whole disks.  It is useful for archiving non-filing system disks which cannot
  23. be done with standard file archivers, sending distribution disks, archiving
  24. library collections, and many other uses.  DMS takes much less time to
  25. put a disk back together than with a file archiver and is less wear and
  26. tear on your disk drives.
  27.  
  28. Why not use other disk archivers?
  29.  
  30.     DMS has been tested against every other similar type programs and will
  31. provide faster execution, greater compression, more support features, and
  32. continuing user support.  Once you try DMS you won't be satisfied with
  33. anything else.  Among other things DMS provides:
  34.  
  35.     - Highly optimized compression routines offerring the utmost
  36.       in speed and compression.  4 different routines to choose from
  37.       to satisfy your needs.
  38.  
  39.     - The ability to read and write to or from any AmigaDOS device conforming
  40.       to the standard 80 tracks , 512 bytes per block , 11 blocks per track,
  41.       2 sides, Ex: DF0:, DF1:, RAD:, etc.
  42.  
  43.     - Extended Virus checking of the boot blocks.  Other disk archivers
  44.       just show the boot block and do not check for viruses, this is
  45.       extremely stupid, most viruses do not come out and say "Look here,
  46.       I'm a virus!".  Without actually checking the boot block you're
  47.       opening up a can of worms.  Therefore DMS currently checks for 15
  48.       known viruses and can automatically install the disk.  It is still
  49.       Important that users monitor their system periodically with a virus
  50.       checker as there are many types of viruses. 
  51.  
  52.     - Data Security.  DMS has the option to encrypt archives with a user
  53.       selected password for security.
  54.  
  55.  
  56. *****************************************************************************
  57.  
  58.                     Command Line Options and Usage
  59.  
  60.   The general format for a DMS command is:
  61.  
  62.   DMS command file[.DMS] [OPTIONS ...]
  63.  
  64.   Everything in braces [] is optional. Everything else is required.
  65.  
  66.   file[.DMS] is a user specified filename.  The .DMS ending will
  67.   automatically be appended to the filename if you do not include it.
  68.   This is done to avoid confusion with other archiver formats.
  69.  
  70.  
  71. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  72.  
  73. 1.) READ
  74.  
  75.   This command will read and compress a disk.  The basic usage for this
  76.   command is:
  77.  
  78.   DMS Read file[.DMS] [FROM Dev:] [TEXT filetext] [CMODE mode] [LOW lowtrack]
  79.                       [HIGH hightrack] [NOVAL] [NOZERO] [ENCRYPT password]
  80.  
  81.   file[.DMS]
  82.  
  83.   - the output file which will contain the archived disk.
  84.  
  85. OPTIONS:
  86.  
  87.   FROM Dev:
  88.  
  89.   - Will read the disk from a different device.  The default device is DF0:
  90.     (internal drive).  You may choose any device as long as it has 80 tracks,
  91.     2 sides, 11 sectors/track, and 512 bytes per sector.
  92.     Examples: DF0:, DF1:, DF2:, DF3:, RAD:, FM0:, FF0:, etc.
  93.  
  94.   TEXT filetext
  95.  
  96.   - Causes DMS to read in the file 'filetext' and add it to the archive.
  97.     When the archive is extracted the text will be displayed before writing
  98.     the disk.  This is useful for identifying disks or giving other
  99.     information about the archive.  
  100.  
  101.   CMODE mode
  102.  
  103.   - Chooses the compression mode used.  Mode is a value from 0 to 4.
  104.     The default mode is 3 - medium compression.
  105.  
  106.     Available modes are:
  107.  
  108.       0 - No Compression               Very quick but no compression
  109.       1 - Simple Compression           Very quick with limited compression
  110.       2 - Quick Compression            Quick with better compression
  111.       3 - Medium Compression (default) Good speed/compression ratio
  112.       4 - Deep Compression             Slowest with the greatest compression
  113.  
  114.     Mode 3 was set as the default because it represents the best size/speed
  115.     combination.  It is recommended that you use this mode if you are
  116.     planning to send archives via modem to many people.  Use mode 4 if
  117.     you have an accelerator card in your machine or for permanent archiving
  118.     where you will only occasionally have to extract the archive.
  119.  
  120.   LOW lowtrack
  121.  
  122.   - Specifies the starting track to read from.  The default is track 0.
  123.     Lowtrack must be a value from 0 to 79.
  124.  
  125.   HIGH hightrack
  126.  
  127.   - Specifies the ending track to stop at.  The default is track 79.
  128.     Hightrack must be a value from 0 to 79.
  129.  
  130.   NOVAL
  131.  
  132.   - Stops DMS from inhibiting the disk validator when reading the disk.
  133.  
  134.   NOZERO
  135.  
  136.   - Normally DMS will read the AmigaDOS bitmap from the disk and archive
  137.     only sectors which are being used.  If the disk is a non-filing system
  138.     disk or has a bad bitmap, DMS will automatically archive the whole disk.
  139.     In EXTREME cases DMS will make a wrong assumption about the type of
  140.     disk it is archiving. NOZERO will cause DMS to archive the whole disk
  141.     totally ignoring the disk bitmap.  Generally you will rarely if ever
  142.     have to use this option.
  143.  
  144.   ENCRPYT password
  145.  
  146.   - Causes DMS to encrypt the input from the disk using the password
  147.     supplied. 'password' is any alphanumeric word you desire.
  148.     Examples: Joe, Fred, ABC1234, ONLY-FOR-ME, etc.
  149.  
  150. EXAMPLES:
  151.  
  152.   DMS read disk1
  153.  
  154.   - Will compress a disk from drive DF0: using the default compression mode
  155.     and store the results in the file 'disk1.DMS'
  156.  
  157.   DMS read stuff.DMS lowtrack 20
  158.  
  159.   - Will compress only tracks 20 to 79 into file 'stuff.DMS'
  160.  
  161.   DMS read stuff lowtrack 40 hightrack 40
  162.  
  163.   - Will compress only track 40 into file 'stuff.DMS'
  164.  
  165.   DMS read stuff from df1: cmode 4 noval nozero text RAM:intro
  166.  
  167.   - Will compress a disk from drive DF1: using compression mode 4, not
  168.     inhibiting the disk validator, not using the disk bitmap and adding
  169.     the text from file 'RAM:intro' to the file 'stuff.DMS'
  170.  
  171.   DMS read stuff.DMS from RAD: encrypt JOESTUFF1
  172.  
  173.   - Will compress a disk from ram drive RAD: and encrypting the output
  174.     with the password 'JOESTUFF1' to file 'stuff.DMS'
  175.  
  176.   DMS read stuff.DMS text CON:0/0/640/200/window
  177.  
  178.   - Will compress a disk and allow you to quickly add text to the archive.
  179.     A console window will open up and you can then type any text you
  180.     want.  To finish type CTRL \ to close the window and continue.
  181.  
  182.  
  183. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  184.  
  185. 2.) WRITE
  186.  
  187.   This command will uncompress and write a disk.  The basic usage for this
  188.   command is:
  189.  
  190.   DMS Write file[.DMS],,, [TO Dev:] [LOW lowtrack] [HIGH hightrack]
  191.                           [NOVAL] [NOTEXT] [NOPAUSE] [DECRYPT password]
  192.  
  193.   file[.DMS],,,
  194.  
  195.   - One or more input files to be extracted.  Standard AmigaDOS wildcards
  196.     are supported.
  197.  
  198. OPTIONS:
  199.  
  200.   TO Dev:
  201.  
  202.   - Will write the output to device Dev: (the default is drive DF0:)
  203.     The device must follows the same rules as in the READ command.
  204.  
  205.   LOW lowtrack
  206.  
  207.   - Specifies the starting track to write from.  Tracks before lowtrack
  208.     will be ignored.  Default is track 0
  209.  
  210.   HIGH hightrack
  211.  
  212.   - Specifies the ending track to write from.  Tracks after hightrack
  213.     will be ignored.  Default is track 79
  214.  
  215.   NOVAL
  216.  
  217.   - Stops DMS from inhibiting the disk validator when writing a disk.
  218.  
  219.   NOTEXT
  220.  
  221.   - Causes DMS to ignore any text to be displayed from the archive.
  222.  
  223.   NOPAUSE
  224.  
  225.   - Stops DMS from pausing after displaying any text from the archive.
  226.  
  227.   DECRPYT password
  228.  
  229.   - Causes DMS to decrypt the archive with the password 'password'.
  230.     This is only used if the archive was previously encrypted.  'password'
  231.     must be the EXACT same one used when encrypting the file otherwise
  232.     the archive will not be processed correctly.
  233.  
  234. EXAMPLES:
  235.  
  236.   DMS write stuff
  237.  
  238.   - Will extract the archive stuff.DMS to drive DF0:
  239.  
  240.   DMS write part1 part2.dms TO DF2: NOTEXT
  241.  
  242.   - Will extract the archives part1.DMS and part2.DMS to drive DF2: ,
  243.     ignoring any banner text in the archives
  244.  
  245.  
  246. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  247.  
  248. 3.) REPACK
  249.  
  250.   This command allows you to recompress an older DMS archive.  It can also
  251.   be used as a simple split utility.  The basic usage for this
  252.   command is:
  253.  
  254.   DMS Repack file[.DMS] [TO file2[.DMS]] [LOW lowtrack] [HIGH hightrack]
  255.                         [CMODE mode]
  256.  
  257.   file[.DMS]
  258.  
  259.   - The input file to be recompressed.
  260.  
  261. OPTIONS:
  262.  
  263.   TO file2[.DMS]
  264.  
  265.   - Causes DMS to store the results in file2.DMS , otherwise the results
  266.     are automatically stored in a file TEMP.DMS
  267.  
  268.   LOW lowtrack
  269.  
  270.   - Specifies lowtrack to start recompression.  Tracks before lowtrack
  271.     will be ignored.  Default is track 0.
  272.  
  273.   HIGH hightrack
  274.  
  275.   - Specifies hightrack to end recompression.  Tracks after hightrack
  276.     will be ignored.  Default is track 79.
  277.  
  278.   CMODE mode
  279.  
  280.   - Chooses the compression mode to use.  Same as in the READ command.
  281.  
  282. EXAMPLES:
  283.  
  284.   DMS repack stuff low 20 high 40 cmode 1
  285.  
  286.   - Will extract tracks 20 through 40 from the archive stuff.DMS ,
  287.     recompress them using compression mode 1 (Simple) and store the
  288.     results in the file TEMP.DMS .
  289.  
  290.   DMS repack old.dms TO new.dms
  291.  
  292.   - Will recompress the archive old.DMS using the default compression mode
  293.     and store the results in the file new.DMS
  294.  
  295.  
  296. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  297.  
  298. 4.) VIEW
  299.  
  300.   This command will view information about a DMS archive.  The basic usage
  301.   for this command is:
  302.  
  303.   DMS View file[.DMS],,, [FULL]
  304.  
  305.   file[.DMS],,,
  306.  
  307.   - One or more input files to be viewed.  Standard AmigaDOS wildcards
  308.     are supported.
  309.  
  310. OPTIONS:
  311.  
  312.   FULL
  313.  
  314.   - Causes DMS to display information about every track in the archive.
  315.     Otherwise only the information header will be displayed.
  316.  
  317. EXAMPLES:
  318.  
  319.   DMS view file1 part#? full
  320.  
  321.   - Will display full information about the archives file1.DMS and
  322.     the files part#?.DMS
  323.  
  324.  
  325. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  326.  
  327. 5.) TEST
  328.  
  329.   This command will test the integrity of a DMS archive.  The basic usage
  330.   for this command is:
  331.  
  332.   DMS Test file[.DMS],,,
  333.  
  334.   file[.DMS],,,
  335.  
  336.   - One or more input files to be tested.  Standard AmigaDOS wildcards
  337.     are supported.
  338.  
  339. EXAMPLES:
  340.  
  341.   DMS test file1 part#?
  342.  
  343.   - Will test the archives file1.DMS and the files part#?.DMS
  344.  
  345.  
  346. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  347.  
  348. 6.) TEXT
  349.  
  350.   This command will display any banner text in a DMS archive.  This is
  351.   used to quickly find out information about an archive without having
  352.   to extract it.  The basic usage for this command is:
  353.  
  354.   DMS Text file[.DMS],,,
  355.  
  356.   file[.DMS],,,
  357.  
  358.   - One or more input files to display text.  Standard AmigaDOS wildcards
  359.     are supported.
  360.  
  361. EXAMPLES:
  362.  
  363.   DMS text file1 part#?
  364.  
  365.   - Will display any banner text from the archives file1.DMS and the files
  366.     part#?.DMS
  367.  
  368. *****************************************************************************
  369.  
  370.                        General Information
  371.  
  372.     DMS has been over a year in the making,  the compression routines
  373. are proprietary and we have taken great care to make sure they are the
  374. very best. There is no other program even close to DMS as far as versatility,
  375. performance, and ease of use.  We have been beta testing for over 4 months
  376. to make sure every little detail is taken care of.  We urge users to
  377. register with us so that we continue to provide the best and continuing
  378. support of the product.
  379.  
  380.     This program is NOT Shareware or Public Domain, it is Copyright 1990
  381. by SDS Software.  We have taken a different approach in distributing this
  382. program than most people.  There will always be a version of DMS available
  383. to the general public free of charge.  However, we are offerring as an
  384. incentive to register, many other programs that will not be available to
  385. the general public.  We feel that you should get what you pay for and pay
  386. for what you use.  Therefore if you seldom use DMS then the public version
  387. is fine for you and we thank you for using it.  If you use DMS on a regular
  388. basis you are asked to register with SDS Software.  Registering will enable
  389. you to receive quickly future updates and other programs not available to the
  390. general public.  Updates will be provided to users on a first-come,
  391. first-serve basis before public releases.  Many of our colleagues have
  392. given up on the Amiga community and have decided to pursue the large
  393. PC/CLONE market.  We have faith in our users and believe that above all,
  394. good software comes through and will be rewarded.  Please make sure that
  395. this program remains the very best by registering with us.
  396.  
  397.     There are 2 levels of registration to choose from:
  398.  
  399.     Regular:
  400.     -------
  401.  
  402.         For $30 you will be mailed a complete hard-copy manual and the
  403.     latest version of DMS on disk.  You will also receive an account on the
  404.     SDS Software bulletin board system and be able to download via modem
  405.     the latest versions free of charge.  If you do not wish or have the
  406.     capability to call the BBS , you can at any time send your disk with an
  407.     SASE and we will copy the latest versions and mail it back to you. 
  408.     It also gives you an unlimited Upload/Download ratio on the BBS for
  409.     one year.  Along with the CLI/Shell version of DMS you will also receive
  410.     when available:
  411.  
  412.         DMSPro - an advanced version of DMS with faster routines and
  413.                  the capability to archive Amax, Mac, MS-DOS, and Atari-ST
  414.                  format disks.
  415.  
  416.         DMSWin - an Intuition version of DMS with full windowing, gadgets
  417.                  and graphical display.
  418.  
  419.     Professional:
  420.     ------------
  421.  
  422.         For $50 you will receive the same privileges as above but will also
  423.     receive when available:
  424.  
  425.         DMS030 - a 68020/030 version of DMS with faster routines optimized
  426.                  for those CPU's
  427.  
  428.         DMSMem - a mega-memory version of DMS with greater compression
  429.                  and faster routines.
  430.  
  431.         Convert - a Warp-to-DMS converter to convert old .WRP files to the
  432.                   new .DMS format.
  433.  
  434.         Convert.EXE - an MS-DOS version of the Warp-to-DMS converter for
  435.                       people storing files on MS-DOS machines.
  436.  
  437.         SelfDisk - a utility to create Self-Extracting disk archives.  It
  438.                    will take an existing DMS archive and change it to be an
  439.                    executable file that anybody can use to extract without
  440.                    having DMS.
  441.  
  442.         You will also receive MS-DOS utilities to test, and view archives.
  443.         These are particularly useful to people running BBS's that carry
  444.         a large volume of files.
  445.  
  446.  
  447.     Send a Check or Money Order for the amount of registration you choose, 
  448. along with your full name, address, phone number, and computer configuration
  449. to:
  450.  
  451.     SDS Software.
  452.     Suite 126
  453.     4885-A Mcknight Rd.
  454.     Pittsburgh, PA  15237
  455.  
  456.  
  457.     It is our sincere hope that we can continue to service the Amiga
  458. community with new and innovative programs.  Please allow us to do so by
  459. supporting our products which you use.  Thank you.
  460.  
  461.     If you have any suggestions, complaints, questions, or bug reports,
  462. please write to the above address and be sure to include your full name,
  463. address, phone number, and computer configuration.
  464.  
  465.     The DISK-Masher (DMS) is Copyright (c) 1990 by SDS Software.
  466. It is NOT Public Domain.  The CLI/Shell GENERIC version is freely
  467. distributable provided the following rules:
  468.  
  469.     1.  No charge excepting reasonable media costs may be charged.
  470.  
  471.     2.  The program and documentation may not be modified in any way.
  472.  
  473.     3.  Only the self-extracting archive DMS102.EXE may be distributed
  474.  
  475.     SDS Software will be in no way liable for damages, incidental, or
  476. consequential, arising from the use or misuse of The DISK-Masher or for
  477. any other claim by any other party.  Use this program at your own risk.
  478.  
  479. *****************************************************************************
  480.  
  481.     Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  482.     MS-DOS is a trademark of Microsoft.
  483.     Atari ST is a trademark of Atari Computers.
  484.     Macintosh is a trademark of Apple Computers.
  485.     Amax is a trademark of Readysoft, Inc.
  486.  
  487.